﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3c.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
  <title>ControlMove</title>


  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

  <link href="../css/commands.css" type="text/css" rel="stylesheet">

  <link media="print" href="../css/print.css" type="text/css" rel="stylesheet">

  <meta content="MSHTML 6.00.2900.3268" name="GENERATOR">

</head>

<body>

<h1>ControlMove</h1>


<p>移动或者重新调整一个控件的大小。 </p>

<p class="CommandSyntax">ControlMove, Control, X, Y,
Width, Height [, WinTitle, WinText, ExcludeTitle, ExcludeText]</p>

<h3>参数 </h3>

<table border="1" bordercolor="#c0c0c0" cellpadding="3" cellspacing="0" width="100%">

  <tbody>

    <tr>

      <td width="15%">Control</td>

      <td width="85%">
      <p>可以是控件的名称/文本或 ClassNN (控件的 classname(类名)和序号)，它们都可以通过
Window Spy 来确定。当使用名称/文本时，matching behavior (匹配模式)通过&nbsp;<a href="SetTitleMatchMode.htm">SetTitleMatchMode</a>
决定。如果此 parameter(参数)为空，目标窗口的顶端控件将被使用。</p>

      <p>要对一个控件的 HWND (窗口 handle (句柄) )进行操作，将 Control 参数留空并为
WinTitle 参数指定 ahk_id %ControlHwnd% (这样即使当 <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a>
是 Off 状态，它也能对隐藏的控件起作用)。一个控件的 HWND 往往由 <a href="ControlGet.htm#Hwnd">ControlGet
Hwnd</a> 、<a href="MouseGetPos.htm">MouseGetPos</a>&amp;
nbsp;或者 <a href="DllCall.htm">DllCall</a> 取得。</p>

      </td>

    </tr>

    <tr>

      <td>X, Y</td>

      <td><em>Control&nbsp;</em>左上角的 X 和 Y
方向的新坐标(用像素单位)，它们可以是 <a href="../Variables.htm#Expressions">expressions</a>(表
达式)。如果任何一个坐标参数为空，那么那种尺寸的 <em>Control</em> 的位置就不会改变。坐标是相对于 <em>Control
      </em>的父窗口的左上角而言的； <a href="ControlGetPos.htm">ControlGetPos</a>
或者 Window Spy 能被用来确定它们。</td>

    </tr>

    <tr>

      <td>Width, Height</td>

      <td> <em>Control </em>新的高度和宽度(用像素单位)，也可以是 <a href="../Variables.htm#Expressions">expressions</a>(表达
式)。如果任何一个参数为空或省略，那种尺寸的 <em>Control&nbsp;</em>的大小将不被改变。</td>

    </tr>

    <tr>

      <td>WinTitle</td>

      <td>
      <div>目标窗口的标题或副标题(匹配模式由&nbsp;<a href="SetTitleMatchMode.htm">SetTitleMatchMode</a>
决定)。如果此参数和后面的3个参数被省略，</div>

      <div><a href="../LastFoundWindow.htm">Last
Found Window</a>(最近找到的窗口)将被使用。如果此参数是字母 A
并且后面的三个参数被省略，active(激活的)窗口将被使用。要使用一个窗口类，指定 ahk_class 确切的类名(通过 Window
Spy 显示)。要使用一个&nbsp;</div>

      <div><a href="Process.htm">process
identifier (PID)</a>(进程标识符)，指定 ahk_pid %包含PID的变量% 。要使用一个&nbsp;</div>

      <div><a href="GroupAdd.htm">window
group</a>(窗口组)，指定 ahk_group GroupName 。要使用一个窗口的&nbsp;</div>

      <div><a href="WinGet.htm">unique
ID number</a>(唯一标识符编号)，指定 ahk_id %包含ID的变量% 。通过指定&nbsp;</div>

      <div><a href="../LastFoundWindow.htm#multi">multiple
criteria</a>(多个条件)缩小搜索范围。例如: <em>My File.txt ahk_class
Notepad</em></div>

      </td>

    </tr>

    <tr>

      <td>WinText</td>

      <td>如果用到，此参数必须是目标窗口的一个单独文本对象的 substring(子字串)(像内置的 Window
Spy 工具显示的一样)。如果&nbsp;<a href="DetectHiddenText.htm">DetectHiddenText</a>
是 ON 的状态，隐藏的文本对象将被探测。</td>

    </tr>

    <tr>

      <td>ExcludeTitle</td>

      <td>标题含有此参数值的窗口将不被考虑。</td>

    </tr>

    <tr>

      <td>ExcludeText</td>

      <td>文本含有此参数值的窗口将不被考虑。</td>

    </tr>

  </tbody>
</table>

<h3>ErrorLevel</h3>

<p>若有错误发生则 <a href="../misc/ErrorLevel.htm">ErrorLevel</a>
的值将被设为 1 ，否则为 0 。</p>

<h3>注意</h3>

<p>为了改善可靠性，每次该命令执行后自动会有一个延迟。这个延迟可以通过 <a href="SetControlDelay.htm">SetControlDelay</a> 来
改变。</p>

<p>窗口标题和文本是 case sensitive(区分大小写)的。隐藏的窗口将不被探测，除非&nbsp;<a href="DetectHiddenWindows.htm">DetectHiddenWindows</a>
已被打开。</p>

<h3>相关命令</h3>

<p><a href="ControlGetPos.htm">ControlGetPos</a>,
<a href="WinMove.htm">WinMove</a>, <a href="SetControlDelay.htm">SetControlDelay</a>, <a href="Control.htm">Control</a>, <a href="ControlGet.htm">ControlGet</a>, <a href="ControlGetText.htm">ControlGetText</a>, <a href="ControlSetText.htm">ControlSetText</a>, <a href="ControlClick.htm">ControlClick</a>,
<a href="ControlFocus.htm">ControlFocus</a>, <a href="ControlSend.htm">ControlSend</a></p>

<h3>示例</h3>

<pre class="NoIndent">SetTimer, ControlMoveTimer<br>InputBox, OutputVar, My Input Box<br>return<br><br>ControlMoveTimer:<br>IfWinNotExist, My Input Box<br> return<br><em>; 否则上面的窗口将为我们设为</em> the "last found" window(<em>最近找到的窗口):</em><br>SetTimer, ControlMoveTimer, off<br>WinActivate<br><strong>ControlMove, OK, 10, , 200</strong> <em>; 将 OK 按钮移至左侧并增加其宽度。</em><br>return</pre>

</body>
</html>
